home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1997 March / macformat-048.iso / Shareware Plus / Developers / trueColor / read me next >
Encoding:
Text File  |  1996-11-30  |  3.6 KB  |  128 lines  |  [TEXT/ttxt]
  1. trueColor
  2.  
  3. trueColor provides an intuitive way to work in color in HyperCard.
  4.  
  5. You can give buttons and fields colors and color pictures.
  6. Buttons can have color icons.
  7.  
  8. You can cut, copy and paste color pictures and icons
  9. to and from the clipboard.
  10. You can move fields and buttons in color.
  11.  
  12. The information about the color properties is
  13. stored within the buttons and fields,
  14. so eg. moving a button with a color icon
  15. requires only to move the button, 
  16. not the button first, and then a color overlay.
  17.  
  18. trueColor requires HyperCard 2.1 or later
  19. a 68020 or higher, preferably a PowerPC or a fast 68k Mac.
  20. Some features require 32-bit QuickDraw (included in Sys 7),
  21. QuickTime, or a monitor with at least 16 colors/grays.
  22.  
  23.  
  24. trueColor is
  25. © Copyright 1996 by Alain Stalder.
  26. All Rights Reserved.
  27. It is free for non-commerial use.
  28.  
  29.  
  30. Changes in 1.02 (dec'96)
  31.  
  32. trueColor now works with HyperCard 2.1 or later.
  33. This was possible, because an external function is used
  34. to collect part properties with the additional result that
  35. painting cards is now about 50-100% faster.
  36.  
  37. There is a minor pitfall if you used an earlier version
  38. of trueColor: you will have to press ctrl-t once on
  39. every background that uses trueColor in order to update it.
  40. This replaces the background button trueColor by 
  41. a field of the same name (HyperCard 2.1 cannot put
  42. any contents into buttons).
  43.  
  44. The external function accesses the open stack as a binary file.
  45. The script version for painting cards is still in trueColor
  46. and is used if the XFCN fails or the version of HyperCard is 3.0 or higher.
  47.  
  48. As a side effect, trueColor is no longer slow in HyperCard 2.2
  49. on PowerMacs that have Connectix SpeedDoubler installed.
  50.  
  51. The screen is now locked before going from card to card.
  52. Color fillings are no longer shown on screens with less
  53. than 16 colors/grays (wrong colors were displayed).
  54. The control-key for showing the pasting options is now ctrl-o.
  55. (ctrl-p is reserved for printing in color.)
  56.  
  57.  
  58. Troubleshooting
  59.  
  60. There is a flaw in Apple's Color Tools that can conflict
  61. with trueColor; it occurs only  if you have colorized
  62. your home stack using Apple's Color Tools.
  63.  
  64. In that case, the following handlers have been put into the
  65. script of your home stack:
  66.  
  67.   on openCard
  68.     Send colorMe to this card
  69.     pass openCard
  70.   end openCard
  71.  
  72.   on closeCard
  73.     lock screen
  74.     pass closeCard
  75.   end closeCard
  76.  
  77.   on openStack
  78.     AddColor install
  79.     pass openStack
  80.   end openStack
  81.  
  82.   on closeStack
  83.     AddColor remove
  84.     pass closeStack
  85.   end closeStack
  86.  
  87. The problem is that for example the openStack message
  88. is sent to the home stack even if another stack  is opened.
  89.  
  90. The solution is simply to check if the home stack was opened.
  91. Just replace the above handlers in your home stack by these:
  92.  
  93.   on openCard
  94.     if long name of this stack is long name of home
  95.     then Send colorMe to this card
  96.     pass openCard
  97.   end openCard
  98.  
  99.   on closeCard
  100.     if long name of this stack is long name of home
  101.     then lock screen
  102.     pass closeCard
  103.   end closeCard
  104.  
  105.   on openStack
  106.     if long name of this stack is long name of home
  107.     then AddColor install
  108.     pass openStack
  109.   end openStack
  110.  
  111.   on closeStack
  112.     if long name of this stack is long name of home
  113.     then AddColor remove
  114.     pass closeStack
  115.   end closeStack
  116.  
  117. Note that your home stack will still be in color, i.e. these changes
  118. are fully compatible with Apple's Color Tools.
  119.  
  120.  
  121. Disclaimer
  122.  
  123. This software is provided "as is" without warranty of any kind,
  124. and I, Alain Stalder, expressly disclaim all implied warranties, 
  125. including but not limited to the implied warranties of merchantability
  126. and fitness for a particular purpose. The entire risk as to the results
  127. and performance of this software is assumed by you.
  128.